home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / contrib / custom-bib / readme < prev    next >
Encoding:
Text File  |  1995-03-10  |  6.2 KB  |  122 lines
  1.                               CUSTOM-BIB Package
  2.  
  3. (Now includes support for other languages.)
  4.  
  5. This is the custom-bib package for generating customized BibTeX bibliography
  6. styles from a generic file by means of Frank Mittelbach's docstrip program.
  7.  
  8. The package contains the following files:
  9.   genbst.mbs   --  A master BibTeX style file for producing customized
  10.                    styles (numerical or author-year) with docstrip. It is
  11.                    self-documenting: simply latex it to produce its
  12.                    description (requires doc.sty).
  13.  
  14.                    This is version 1.6. Many new options have been added
  15.                    at the suggestions of active users. 
  16.                    
  17.   babel.mbs    --  A variation of genbst.mbs for multilingual support. It
  18.                    can produce .bst files for English, French, German,
  19.                    Esperanto, and is extendable. Alternatively, one selects
  20.                    the `language' babel, and the language-specific words are
  21.                    replaced by commands that need to be defined in a separate
  22.                    input file. This file is automatically read in by the .bbl
  23.                    file.
  24.  
  25.                    This is version 2.4. It is otherwise equivalent to
  26.                    genbst.mbs version 1.6.
  27.                    
  28.   xbtxbst.mbs  --  The master bib style file used by Oren Patashnik (with
  29.                    minor additions by others) for C Preprocessor (XBTXBST.DOC)
  30.                    converted to the docstrip scheme here, with all original
  31.                    comments put into LaTeX format. LaTeXing this file produces
  32.                    the documentation of the original Patashnik text. 
  33.                    
  34.                    This is version 1.1. 
  35.                    
  36.   makebst.dtx  --  the documented source file; LaTeXing this file produces
  37.                    the manual and optionally a documentation of the coding.
  38.                    Requires ltxdoc class from the LaTeX2e distribution.
  39.  
  40.                    This is version 2.1; the documentation requires 
  41.                    LaTeX2e (1994/06/01). The program itself only requires TeX.
  42.  
  43.                    See the note on list of options at the end of this file for
  44.                    the only new feature over version 2.0.
  45.                    
  46.   makebst.ins  --  a docstrip batch job to extract from makebst.dtx the 
  47.                    program file makebst.tex.
  48.  
  49. Many authors are frustrated at the wide range of bibliographic styles demanded
  50. by journals and publishers, and at the limited number available with standard
  51. LaTeX and BibTeX. This is not the fault of the latter, but rather of the lack
  52. of any bibliographic standards in the English language. Often the differences
  53. are so trivial (comma or colon, date in brackets or parentheses). The normal
  54. user does not want to tackle the task of making up his own .bst file (no
  55. normal human would!) 
  56.  
  57. For this reason, I set out to produce a generic .bst file that could have
  58. features and options selected by means of Mittelbach's docstrip program. 
  59. I found over 50 different *.bst files and compared their outputs just for
  60. article: they were all different. They served as part of my input as to what
  61. features were needed. I knew of a few extra that were not covered by these 50.
  62.  
  63. I also discovered XBTXBST.DOC, a minor modification of Patashnik's BTXBST.DOC,
  64. as well as a file PHYSICS.BST, all of which are meant to do precisely what I
  65. had set up to accomplish. However, they make use of the C Preprocessor
  66. language. It is really a simple matter to convert the preprocessor commands
  67. into docstrip equivalents. 
  68.  
  69. Nevertheless, none of these really met all of my needs, so I continued to
  70. develop GENBST.mbs (GENeric-BibST.MasterBibSt). It soon became obvious that the
  71. sheer number of options necessary made any kind of customizing a difficult
  72. chore. Hence, the next step: the program MAKEBST takes menu information from
  73. the selected .mbs file and presents the user with descriptive choices as
  74. menus. From the answers, it writes a docstrip batch job (extension .dbj) which
  75. when TeX'ed, creates the desired .bst file out of the .mbs one. The .dbj file
  76. may even be hand edited if one wants to alter only one or two options.
  77.  
  78. To use the package: (I assume you have docstrip.tex and doc.sty; if you do not
  79.   have the former, then you cannot use the package anyway; they are now part
  80.   of the standard LaTeX distribution from 1994 June 1.)
  81.  
  82. 1. run TeX (or LaTeX) on makebst.ins (--> makebst.tex)
  83. 2. (optional) LaTeX makebst.dtx to get the documentation;
  84. 3. run TeX (or LaTeX) on makebst.tex to start customizing
  85.      your own .bst file. You may select the master file as either genbst,
  86.      babel, or xbtxdoc.
  87.      
  88. For documentation on the master bib files, just LaTeX genbst.mbs, babel.mbs
  89. or xbtxbst.mbs themselves. (Note, xbtxbst.mbs will also output the Patashnik
  90. comments to the coding. I have not yet managed to do this for genbst.mbs)
  91.  
  92. NOTE ON AUTHOR-YEAR CITATIONS:-
  93. Author-year style citations are not supported by standard LaTeX and BibTeX.
  94. However, there exist a large number of bib styles for this, all of which need
  95. some interface package to run properly. I have identified 5 different 
  96. interfaces, plus a 6th one that I use myself (see the NATBIB package in a
  97. parallel directory). I have made up genbst.mbs to be able to produce .bst
  98. files for all 6. If one selects author-year style, then one is asked which
  99. interface package is to be used. (Incidentally my natbib.sty is capable of
  100. interpreting all 6).
  101.  
  102. LIST OF ALL OPTIONS IN THE DBJ FILE (new to version 2.1 from 1994 Dec 29)
  103. The makebst program writes to the .dbj file all the docstrip options
  104. that were offered in the interactive session. This makes editing afterwards
  105. much easier. Often one wants to experiment with some of these options, but
  106. only wants to run the makebst program once.
  107.  
  108. This feature (requested by Frank Mittelbach) is available when the 
  109. makebst.tex file is extracted from makebst.dtx with the `optlist' option;
  110. without it, only the selected options are listed in the .dbj file.
  111. Edit the makebst.ins file accordingly; by default, this feature is included.
  112.  
  113. 1995 Feb 2
  114. Patrick W. Daly
  115. Max-Planck-Institut f\"ur Aeronomie
  116. D-37189 Katlenburg-Lindau, Germany
  117. E-mail:
  118. Internet-- daly@linax1.dnet.gwdg.de
  119.  
  120.   
  121.   
  122.